home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 2000 October / Software of the Month - Ultimate Collection Shareware 277.iso / pc / PROGRAMS / UTILITY / WINLINUX / DATA1.CAB / programs_-_usrdoc / NETWATCH / README.{__ < prev    next >
Text File  |  1999-09-17  |  4KB  |  125 lines
  1.     Version 0.7 (NETWATCH)
  2.  
  3.     NETWATCH is VERY loosely based on the code from Statnet...
  4.     thanks out to Jeroen and Scot...
  5.     
  6.     NETWATCH allows a user (superuser) to monitor an ETHERNET
  7.     and examine activity on the network. Hostnames are highlighted
  8.     in colours (for those supporting them) to indicate activity
  9.     on the bus network based on time ( less than 1 minute RED,
  10.     less than 5 minutes YELLOW, less than 30 minutes GREEN and
  11.     otherwise BLUE). The monitor includes statistics on 
  12.     a) Transmitted and received packets 
  13.     b) Transmitted and received bytes
  14.     c) Protocol of LAST packet (TX or RC)
  15.     d) LAST Communication partner (IP address)
  16.     e) Logging entire stats to ASCII file (large...)
  17.  
  18.     The number of hosts capable of support is a function of
  19.     memory. They are stored in 2 doubly-linked lists (local
  20.     and remote).
  21.     
  22.     Screen updates take place 1 per second (unless a rare 
  23.     lockout... when linked list links are updating... in which
  24.     case it displays in the next second)
  25.     
  26.     Keyboard usage is admittedly limited.
  27.     TAB    Switches between LOCAL and REMOTE sections of screen
  28.     <RIGHT>    Go forward to next display option
  29.     <LEFT>     Go backward to previous display option 
  30.     <UP>     Go back to previous page (back 20 lines on most consoles)
  31.             (working on the selected REMOTE OR LOCAL section)
  32.     <DOWN>    Go forward to next page (forward 20 lines on most consoles)
  33.             (working on the selected REMOTE OR LOCAL section)
  34.     c    Clear counters for fresh counting
  35.     n    Clear linked lists for new start
  36.     d    Toggle between allowing remote DOMAIN service hosts and not
  37.     b    Toggle between showing the OLD (blue) hosts and not
  38.         
  39.     There is rudimentary logging capability, using the 'l' command.
  40.     This saves the current statistics (all) to a file called
  41.     "/etc/netwatch.use". WARNING: This file may get VERY large.
  42.     Statistics for the local machines are dumped THEN the remote
  43.     machines. This info is APPENDED to the file.
  44.     LOGGING is under improvement... stay tuned
  45.  
  46.     It is a simple program to execute for ETHERNET under LINUX.
  47.     As of version 0.6a, the program will search for information
  48.     from the "/proc" file system. If it is not there, 
  49.     it assumes that there is a "/etc/rc.d/rc.inet1" file for
  50.     network configuration. If so, it checks for an "eth0" ifconfig
  51.     and picks up the netmask from the file.
  52.     
  53.     For those with multiple "eth" interfaces, I am sorry it doesn't
  54.     support both simultaneously. Code changes are required for 
  55.     "eth1" support.
  56.  
  57.     As of version 0.6a, this program calls home with a simple
  58.     packet of info including the domain and machine name which
  59.     is running. It is not used for anything except registering
  60.     netwatch use on the Internet. It creates a file in your home
  61.     directory called ~/.netwatch. If the file is already there,
  62.     it does not call home. This means that it will call home only
  63.     once for the program. It is not a true registration in the
  64.     sense of obtaining a license (or anything like that). Info
  65.     transmitted is very limited.
  66.  
  67.     Thanks to Evan Harris for mods. to "netwatch" for varying size
  68.     screens (Sorry that I haven't implemented them yet... Next 
  69.     release...)
  70.  
  71.     AUTHOR:    G. MacKay
  72.     E-MAIL:    mackay@gmml.slctech.org
  73.     
  74.  
  75. INSTALLATION:
  76.  
  77.     1.0    Unpack the ARCHIVE (which you have probably already done
  78.         to read this)
  79.         Try:
  80.  
  81.         tar -xzf netwatch0.6a.src.tar.gz
  82.         cd netwatch        (move to the new directory with
  83.                         source)
  84.  
  85.     2.0    Check to see if your system has "ncurses.h" or "curses.h"
  86.         If /usr/include/ncurses.h ... make sure that you declare
  87.         OLDLINUX=-DOLDLINUX  in the Makefile.....
  88.  
  89.     3.0    Compile the program
  90.  
  91.         make netwatch        (actually "make" by itself works)
  92.  
  93.     4.0    If there are no errors, you can EITHER (or do both)
  94.  
  95.         a) test the program out....
  96.  
  97.             netwatch
  98.  
  99.         b) install the program
  100.  
  101.             make install
  102.  
  103.             (Warning... you must be root to install
  104.             AND due to the nature of the program
  105.             it is NO LONGER SET-UID root... you must
  106.             have privileges to run it)
  107.  
  108.  
  109.  
  110.     Good luck...
  111.  
  112.     Gord.
  113.  
  114.  
  115. WHAT IS COMING?
  116.  
  117.     Yes... an X-windows version is coming and is being tested right
  118.     now. The version is written with V code and original "netwatch"
  119.     code. I have yet to include a full set of features but the basic
  120.     monitoring does function. Hopefully, this will be available
  121.     VERY soon.... look for xnetwatch0.7 (mirroring the level of
  122.     "netwatch" for ncurses).
  123.  
  124.  
  125.